ASP Advantage 1994 2nd Q2

home *** CD-ROM | disk | FTP | other *** search

/ ASP Advantage 1994 2nd Q2 / The Association of Shareware Professionals - The Official ASP Advantage (2nd Quarter)(1994).bin / files / utilstem / pman115 / path_man.doc < prev next >

Wrap

Text File | 1994-01-01 | 41.3 KB | 1,207 lines

Ç ──────────────────────────────────────────── Ç ┼┐════════════════════════════════════════════ ╔╬╗ ┴ ╨║╨ ┐ ╔╩╗ ┴ ╨ ╨ ▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒█▀▀▀▒▒█ ▒▒▒▒▄ ▒▒█▀▀▀ ▒▒█ ▒▒█ ▒▒▒▄ ▒▒▒█ ▒▒▒▒▄ ▒▒▒▄ ▒▒█ ▒▒▒▒▒▒▒▒█ ▒▒█▀▒▒▄ ▒▒█ ▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█ ▒▒█▀▒▒▄ ▒▒█▒▒▄▒▒█ ▒▒█▀▀▀▀▀▀ ▒▒▒▒▒▒█ ▒▒█ ▒▒█▀▀▀▒▒█ ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█ ▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ Welcome to PATH_MAN, a utility program to determine if a file is located on a PATH directory! ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ U S E R M A N U A L Version 1.1 ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ Copyright 1991-1994 by MicroMetric. All rights reserved. Document last edited: January 1, 1994 PATH_MAN is distributed as SHAREWARE and, as such, may be copied and shared on a private non-commercial basis with others in its unmodified form. Liability is limited to replacing the software for registered users. There is no liability for any damage or loss caused by this software, directly or indirectly. ┌────────────────────────────────────────────────┐ │ ┌───────┐ │█ │ ┌────┴──┐ │ (R) │█ │ ──│ │O │─────────────────── │█ │ │ ┌────┴╨─┐ │ Association of │█ │ │ │ │─┘ Shareware │█ │ └──│ O │ Professionals │█ │ ─────│ ║ │───────────────────── │█ │ └───╨───┘ MEMBER │█ └────────────────────────────────────────────────┘█ ██████████████████████████████████████████████████ If you have problems with this program, or want to send comments, manual correc- tions, or enhancement suggestions, you may call or mail them to: MicroMetric 98 Dade Avenue Sarasota, FLorida 34232-1609 USA Technical Support (813) 377-2515 FAX . . . . . . . (813) 377-2091 Support BBS . . . (813) 371-2490 The MicroMetric Software Support BBS provides availability and technical support for the MicroMetric ■■■■_MAN series of shareware programs. First time callers have access to the board and can leave messages or download replies/current shareware releases. Registered users may also download the latest Beta test software releases, when available. Additionally, you can send routed E-Mail via the RIME(tm) network to David Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con- ferences. I also check CompuServe (71631,744), but only on an infrequent basis. PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc. MS-DOS is a registered trademark of the Microsoft Corporation. IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation. ii TABLE OF CONTENTS INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Manual Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . 1 Computer key conventions . . . . . . . . . . . . . . . . . . . . . . 1 Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 ■■■■_MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Shareware distributed documentation manual . . . . . . . . . . . . . 2 Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Installation on Non-Path Referenced Directories . . . . . . . . . . . . 5 From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . . 5 From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Program Operation with Microsoft Windows . . . . . . . . . . . . . . . . 11 RUNNING PATH_MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 FileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 ERRORLEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 PATH_MAN FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 iii TABLE OF CONTENTS PATH_MAN Version 1.1 iv INTRODUCTION PATH_MAN is a utility that searches the directory path elements of the PATH statement for a given file. The search file name may include DOS wildcard char- acters. The ERRORLEVEL variable is set, based on the results of this search, to allow more user friendly batch files - a graceful exit can be made when needed data files or programs are missing. Optionally, the path element on which the search file is located may be displayed. Major Features * Searches the directory path elements of the current PATH statement for a given file. * Sets the ERRORLEVEL variable, based on the results of this search, to allow more user friendly batch files - a graceful exit can be made when needed data files or programs are missing. * Optional display of the first path element on which the search file name is found. * DOS wildcard characters of * and ? may be used in the search file name. * Small size and fast operation. System Requirements PATH_MAN will run on an IBM PC, XT, AT or true compatibles. It has been tested with PC-DOS/MS-DOS operating systems, version 3.0 through version 6.0. Manual Format This manual is divided into several introductory chapters followed by chapters for operating PATH_MAN. The format of these chapters and the information pre- sented therein has been standardized using the following conventions. Page layout - Each page has a header detailing the chapter and the program ver- sion covered. A footer displays the manual page number. Brackets and parentheses - Brackets, [...], are used in the manual and in the help screens to specify what should be entered in response to the current prompt. If a character string is to be entered, the type of character is noted, such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments. Computer key conventions - Keys specified in the manual text that are not in entry brackets are shown as reversed, such as ESCAPE . All key references are in capital letters for clarity. Action steps - Some procedures may require selection from a menu of options, inputting data or following a sequence of steps. Most manual sections will first give an overview of the function or task under discussion and then detail the various action operating procedures. In order to make this manual easier to use a symbol, -> , marks the beginning of each of these action operating procedures. ■■■■_MAN programs - The general group of shareware programs by MicroMetric is referred to by the name ■■■■_MAN. It may also be used in reference to a specific program in that group. 1 INTRODUCTION PATH_MAN Version 1.1 Shareware distributed documentation manual - The documentation file included on the shareware distribution diskette contains the same information as the printed and bound manual, supplied as part of registration, with two exceptions, the result of the word processor, formatting, and printer used. The first is that all of the control display characters (ASCII 1-31) and the reverse print key- board codes are NOT shown properly. Finally, bolding, underlining, and special symbols are NOT present. Shareware PATH_MAN is being distributed as SHAREWARE. The SHAREWARE concept allows users to examine a program on a trial basis, at no (or minimal) charge, before pur- chasing it. In addition, by decreasing marketing costs, professional quality software may be distributed for a fraction of the cost of a comparable commer- cial product. Regardless of whether you register the program, please help dis- tribute PATH_MAN by sharing unmodified copies of it and its files with others. You are hereby granted the right to use the PATH_MAN program for a thirty (30) day evaluation period. If you find PATH_MAN of value, and continue to use it after this evaluation period, YOU MUST REGISTER YOUR PROGRAM USE. This will provide you with: * A 7" x 8 1/2" printed and bound manual. * PATH_MAN phone or mail support for one year. * Notification of the next PATH_MAN release. * Ability to suppress the shareware registration reminder message displayed at the end of the program. * An installation/update/registration branding program. * Sincere thanks for your support of the SHAREWARE concept. A Single System Program Registration entitles the user to unlimited use of the PATH_MAN program on a single computer. A Site License Program Registration entitles the user to unlimited use of the PATH_MAN program on all computers, including networks, at a single corporate location. Program Registration, Single System . . . . . $15. Includes latest version diskette and manual Program Registration, Site License . . . . $100. Includes latest version diskette and manual Latest Version Diskette only . . . . . . . . $5. Shipping - USA/Canada/Mexico . . . . . . . . $5. Shipping - Outside of USA/Canada/Mexico . . . $10. COD orders, add $5. Florida residents, add 7% sales tax. You should specify diskette size and density desired. If none is specified, 3½" DSHD will normally be supplied. 2 PATH_MAN Version 1.1 INTRODUCTION ADDRESS: MicroMetric 98 Dade Avenue Sarasota, FLorida 34232-1609 USA PHONE: Technical Support (813) 377-2515 FAX . . . . . . . (813) 377-2091 Support BBS . . . (813) 371-2490 Order Line . . . (800) 929-0184 For ease in program registration, a registration order form may be printed at the program exit or there is a quick registration form that is available with the program F1 help key. This program is produced by a member of the Association of Shareware Profession- als (ASP). ASP wants to make sure that the shareware principal works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In communications with the Ombudsman please include a telephone number and/or FAX if available. 3 INTRODUCTION PATH_MAN Version 1.1 4 INSTALLING THE SYSTEM Installation on Non-Path Referenced Directories If the PATH_MAN files are not located on PATH referenced directories, then, when executing PATH_MAN, either: 1. The drive-directory on which they are located must be made the current one, or 2. The drive-directory on which they are located must be specified on the command line. See the chapter "Running PATH_MAN" for more complete details on operation if the files are not located on path directories. From a Diskette Vendor If the PATH_MAN program has been obtained from a diskette vendor, you should follow any of their instruction on unpacking/installing the programs (if indeed they have separate instructions.) The program, and its files, can be supplied as a self extracting file whose name is "PMANvvv.EXE" (vvv is the version, such as "PMAN100"). This file should first be copied to a directory on your hard disk. This direc- tory may be a new one, such as one named "PATH", and created specifically for PATH_MAN, or a current one, such as "UTILITY", that has other programs/files. For information on creating a separate directory, see your DOS manual. Once the file is copied to the desired hard disk directory, at the DOS prompt change to this drive directory, and then type the EXE file name (such as "PMAN100") and press ENTER . This will unpack all of the PATH_MAN files. From a BBS If the PATH_MAN file was downloaded from a Bulletin Board, it should first be copied to a directory as defined above, and then unpacked, using whatever pro- gram is specified by the Bulletin Board. It is normally distributed with a name of "PMANvvv.ZIP" (vvv is the version) or "PMANvv.ZIP" and requires the program PKUNZIP, version 2, to unpack the files. Registered Version Registered users should use the program "INSTALL", that is supplied upon regis- tration. This program will create a registration file which will, in turn, sup- press the shareware registration reminders. -> To install PATH_MAN on your hard disk, or to upgrade to a new release, follow the steps detailed below: 1. Place the PATH_MAN distribution diskette in your floppy diskette drive. 2. At the DOS prompt, change to the drive in which the distribution diskette is located. For example, if the diskette was placed in drive A, type A : and press ENTER . 5 INSTALLING THE SYSTEM PATH_MAN Version 5.1 3. Type I N S T A L L and press ENTER . The installation program will then be loaded, and its display should be as shown below. ╒═╡ INSTallation MANagement Program ╞══════════╡ Started at═>12-31-99 08:00 ╞═╕ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ │░ ░░▄ ░░▄ ░░▄░░░░░░░░▄░░░░░░░░▄ ░░▄ ░░▄ ░░▄ ░░▄ ░░▄░│ │░ Ç ░░█ ░░░▄ ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀ ░░░▄ ░░░█ ░░░░▄ ░░░▄ ░░█░│ │░ ┌┼┐ ░░█ ░░█░░▄░░█░░░░░░░░▄ ░░█ ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│ │░ ┌┴┐ ░░█ ░░█ ▀░░░█ ▀▀▀▀▀░░█ ░░█ ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│ │░═┴═┴═░░█ ░░█ ░░█░░░░░░░░█ ░░█ ░░░░░░▄ ░░█░░█░░█░░█▀▀▀░░▄░░█ ░░█░│ │░ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀░│ ╘╡ INST_MAN Version 4.20 Copyright 1990-94 MicroMetric, All Rights Reserved ╞╛ F1>Help│ESC>Exit│<┘/[char]>Select│ HomeEnd│ NOTE Context sensitive help is available from this point on in the in- stallation program on, by pressing the F1 key. 4. If a color video card is detected, the following prompt will be displayed. ┌──────────────────────────────────────┐ │ ╔═╡ Color Monitor Card Detected ╞═╗ │ │ ║ Use the color display ║█ │ │ ║ Force a monochrome display ║█ │ │ ╚═════════════════════════════════╝█ │ │ ███████████████████████████████████ │ └──────────────────────────────────────┘ -> If your system has a color monitor, press U . -> If your system has a monochrome or LCD display, press F . 5. A selection list of all path referenced directories is next displayed. NOTE Although PATH_MAN will run from a non-path directory, placing its files on any path-referenced directory(s) allows the directory from which files are to be printed to be set as the current directory, before executing the program. ┌────────────────────────────────────────────┐ │ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐ │ │ │ C:\BAT │█ │ │ │ C:\DOS-500 │█ │ │ │ C:\UTILITY │█ │ │ │ C:\ZIP │█ │ │ │ C:\ │█ │ │ │ User Defined Drive-Directory Path │█ │ │ └───────────────────────────────────────┘█ │ │ █████████████████████████████████████████ │ └────────────────────────────────────────────┘ -> To cancel the installation program at this point, press ESCAPE . -> To select one of the path referenced directories on which to install PATH_MAN, move the highlight bar to it and press ENTER . -> To specify a non-path referenced directory on which to install PATH_MAN, press U and then press ENTER . A data entry window for the installation 6 PATH_MAN Version 5.1 INSTALLING THE SYSTEM path will then be displayed, as shown below (with an example path already entered). Enter the desired drive and directory path on which to install PATH_MAN, using the control keys described on the bottom help line. NOTE INSTALL can only create directories one level deeper than that which currently exists. If the directory C:\ABC exists, the di- rectory C:\ABC\XYZ may be created; if C:\ABC does not already exist, an error will occur. ┌────────────────────────────────────────────────────────────────────────┐ │ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐ │ │ │ C:\PATH │█ │ │ └───────────────────────────────────────────────────────────────────┘█ │ │ █████████████████████████████████████████████████████████████████████ │ └────────────────────────────────────────────────────────────────────────┘ -> To cancel defining the path, press ESCAPE . The program will return to directory selection. -> To accept the path as entered and edited, press ENTER . If the speci- fied directory does not currently exist, the following message will be displayed. ┌────────────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐ │ │ │ The drive-directory path as entered DOES NOT currently exist. │█ │ │ │ This directory WILL NOW BE created. │█ │ │ └───────────────────────────────────────────────────────────────┘█ │ │ █████████████████████████████████████████████████████████████████ │ └────────────────────────────────────────────────────────────────────┘ -> To cancel creation of this directory, press ESCAPE . -> To create it, press ENTER . If the specified drive is invalid or the requested installation directory's parent does not exist, an error message will be displayed. ┌─────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├────────────────────────────────────────────┐ │ │ │ The drive-directory path as entered CANNOT BE CREATED. │█ │ │ │ Please edit and CORRECT this path. │█ │ │ └────────────────────────────────────────────────────────┘█ │ │ ██████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────┘ Press any key, and then re-edit the installation path. 6. A TYPE OF INSTALLATION selection menu will next be displayed. INSTALL will process either ■■■■_MAN SYSTEMS or their SUPPLEMENTAL FILES. SYSTEMS consist of the files necessary for basic program operation. SUPPLEMENTAL FILES contain additional information needed to accomplish added support or increased functionality. 7 INSTALLING THE SYSTEM PATH_MAN Version 5.1 ┌───────────────────────────────┐ │ ╔═╡ TYPE OF INSTALLATION ╞═╗ │ │ ║ Systems - Programs ║█ │ │ ║ supplemental Files ║█ │ │ ║ eXit Installation ║█ │ │ ╚══════════════════════════╝█ │ │ ████████████████████████████ │ └───────────────────────────────┘ -> To install one or more SYSTEMS at this time, press S . A menu of avail- able SYSTEMS will then be displayed. For further installation instruc- tions, go to the next step. NOTE THIS APPLICATION CURRENTLY DOES NOT HAVE ANY SUPPLEMENTAL FILES. -> To exit the INSTALL program at this time, press X . 7. If more than one system is available for installation, a SYSTEM TO INSTALL selection menu will be displayed, as shown below. ┌─────────────────────────────────────────────────────────────────────────────┐ │ ╔═╡ TAG ╞╡ Select the SYSTEM(S) TO INSTALL ╞═════════════════════════════╗ │ │ ║ DMAN100 SINGLE SCREEN data/graphical summary all disk drives ║█ │ │ ║ EMAN100 Environment data summary, environ. space remaining ║█ │ │ ║ FMAN100 Menu driven DOS file manager, directory tree ║█ │ │ ║ LMAN100 Print text files on a laser printer, 36 print styles ║█ │ │ ║ MMAN100 Display custom user selection menus from batch files ║█ │ │ ║ PMAN100 Determines if a file is on a PATH directory ║█ │ │ ║ VMAN100 Display and edit files in both ASCII and Hex ║█ │ │ ║ ------ eXIT SELECTION AND INSTALL ALL TAGGED (√) ------ ║█ │ │ ╚════════════════════════════════════════════════════════════════════════╝█ │ │ ██████████████████████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────────────────────┘ -> To terminate the installation program at this point, press ESCAPE . -> To toggle the INSTALL TAG for a given SYSTEM, press its highlighted letter or move the highlight bar to in with the arrow keys and press ENTER . A [√] character to the left of the SYSTEM name denotes that this SYSTEM will be installed. -> To conclude the SYSTEM selection process, press X . The INSTALLATION FUNCTION menu for each selected system will then be displayed. 8. A list of all of the selected SYSTEMS files is next displayed, along with an INSTALLATION FUNCTION menu. The normal sequence of operations is to first "Install" the SYSTEM program and files, and then "Brand" the SYSTEM with your name and serial number. ┌─────────────────────────────────────────────────────────────┐ │ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕ │ │ │ Install system Brand system eXit │█ │ │ ╘════════════════════════════════════════════════════════╛█ │ │ ██████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────┘ 8 PATH_MAN Version 5.1 INSTALLING THE SYSTEM ┌──────────────────────────────────────────────────────────────────────────────┐ │╒═╡ File Name Status Hard Disk Path/File Description XXXX100 FILES ╞═╕ │ ││ System═>XXXX_MAN This system does .................. │█│ ││ XXXX_MAN.EXE PROCESS Main program for this application │█│ ││ YYYY.YYY PROCESS Other files... │█│ │╘═╡ INSTALLATION PATH═>C:\PATH ╞════════════════════════════════════════════╛█│ │ █████████████████████████████████████████████████████████████████████████████│ └──────────────────────────────────────────────────────────────────────────────┘ -> To install the SYSTEM on the hard disk, insure that the highlight bar is on the "INSTALL SYSTEM" FUNCTION and press ENTER . Each of the file(s) will be copied to the selected installation drive-directory. NOTE A happy face symbol after any of the SYSTEM's file names denotes that this file is already on the hard disk. During installation it will be replaced, on the directory where it currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH. If any of the files to be installed is already present, a ACTION menu will be displayed during its installation. ┌───────────────────────────────────────────────────────┐ │ ┌─┤ Highlighted file(s) already present. ACTION? ├─┐ │ │ │ Erase current file(s) and update │█ │ │ │ erase and update this and All later file(s) │█ │ │ │ Leave current file(s) 'as is' │█ │ │ │ leave current and Skip the remaining file(s) │█ │ │ └──────────────────────────────────────────────────┘█ │ │ ████████████████████████████████████████████████████ │ └───────────────────────────────────────────────────────┘ -> To process the current file, select the proper ACTION to take by press- ing its highlighted letter or moving the highlight bar to it and press- ing ENTER . When all files have been copied to the hard disk, a copy complete message is displayed. ┌───────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐ │ │ │ FILE COPY COMPLETED. │█ │ │ │ All of the required PATH_MAN files are on the hard disk. │█ │ │ │ ═══> PATH_MAN IS READY TO RUN. <═══ │█ │ │ └──────────────────────────────────────────────────────────┘█ │ │ ████████████████████████████████████████████████████████████ │ └───────────────────────────────────────────────────────────────┘ -> To cancel the installation at this point, press ESCAPE . -> To continue with the installation, press any other key. The highlight bar will then be on the "BRAND SYSTEM" FUNCTION. 9. To brand the system with your name and serial number, move the highlight bar to the "BRAND SYSTEM" FUNCTION and press ENTER . A REGISTRATION INFORMATION data entry window will be displayed, as shown below, with sample data already entered. NOTE This step is REQUIRED for PATH_MAN to be registered. Also, if you 9 INSTALLING THE SYSTEM PATH_MAN Version 5.1 move the PATH_MAN files to another drive-directory you will need to "BRAND" the system again. Enter your company and/or your name, and then the system registration number. Your registration number is located on the back of the front cover of this manual. ┌──────────────────────────────────────────┐ │ ┌─┤ REGISTRATION INFORMATION ├────────┐ │ │ │ Name ABC COMPANY, George Jones │█ │ │ │ Registration number 12345678 │█ │ │ └─────────────────────────────────────┘█ │ │ ███████████████████████████████████████ │ └──────────────────────────────────────────┘ -> To accept either the name or registration number after entry and edit- ing, press ENTER . A message will be displayed after the registration number is entered. It's contents are dependent on whether the registra- tion number is valid. Both messages are shown below. ┌───────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├──────────────────────────────┐ │ │ │ PATH_MAN serial number entered is VALID. │█ │ │ └──────────────────────────────────────────┘█ │ │ ████████████████████████████████████████████ │ └───────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├────────────────────────────────┐ │ │ │ PATH_MAN serial number entered is INVALID! │█ │ │ │ Please try again. │█ │ │ └────────────────────────────────────────────┘█ │ │ ██████████████████████████████████████████████ │ └─────────────────────────────────────────────────┘ -> To continue with the installation program, press any key. If the registration number was valid, the "EXIT" option is highlighted. If it was invalid, select the "BRAND SYSTEM" option again. 10. To exit from this SYSTEMS installation function, move the highlight bar to the "EXIT" FUNCTION and press ENTER . If the SYSTEM has been properly branded, it is ready for use, and the program will either install the next selected SYSTEM, Step 8, or return to the TYPE OF INSTALLATION MENU, Step 6. If the system has not been branded, an error message is displayed, as shown below. ┌─────────────────────────────────────────────────────────────────┐ │ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐ │ │ │ This system has not been 'BRANDED'. │█ │ │ │ In order to be registered, it must first be 'BRANDED'! │█ │ │ │ To exit without BRANDING, press ESCAPE. │█ │ │ │ To continue with the INSTALL program, press any other key. │█ │ │ └────────────────────────────────────────────────────────────┘█ │ │ ██████████████████████████████████████████████████████████████ │ └─────────────────────────────────────────────────────────────────┘ 10 PATH_MAN Version 5.1 INSTALLING THE SYSTEM Program Operation with Microsoft Windows PATH_MAN may be run as a DOS application under Windows. To aid in its operation, an icon file, "PATH_MAN.ICO", and a program information file, "PATH_MAN.PIF", have been included. These should be installed into a Windows program group. See your Microsoft Windows manual for specific installation details. 11 INSTALLING THE SYSTEM PATH_MAN Version 5.1 12 RUNNING PATH_MAN The syntax to execute the PATH_MAN utility program is: PATH_MAN FileName[option] A space MUST be present after the program name and before the FileName parame- ter. A space MUST NOT be placed between the FileName and the option, if it is present. FileName The file name to be found follows the standard DOS conventions, with a maximum of eight characters for the file name and three characters for the extension with a '.' separator. The DOS wildcard characters of ? and * may be used. If no extension is specified, the match will be on name with all extensions matching. Option If the FileName is followed by a '?' character, the program will display the search results. If a matching file is found, a message with the path of the FIRST matching file is displayed. If no matching file is found, a message with the FileName searched for is displayed. In both cases the ERRORLEVEL value is also displayed. NOTE: A '?' at the end of the FileName[option] is always treated as an option rather that a DOS wildcard '?'. Operation PATH_MAN searches the path directory elements referenced in the PATH statement in the order in which they appear. For example, with the PATH statement - PATH=[D1:Path1][D2:Path2][...] the path element D1:Path1 is searched first followed by D2:Path2. If a match is found, the search is terminated and the ERRORLEVEL variable is set. ERRORLEVEL The ERRORLEVEL variable is set based on the results of the search for FileName. If a match to FileName is found on any of the path directory elements of the PATH statement, ERRORLEVEL is set to the ordinal number of the Dx:Pathx path on which the file is found. This number may range from one to the number of ele- ments in the PATH statement. If PATH_MAN is not present or FileName is NOT found on any of the path directory elements of the PATH statement, ERRORLEVEL is set to 0. NOTE: PATH_MAN's use of the ERRORLEVEL variable is the inverse of many (if not most) programs: a zero ERRORLEVEL is bad and a non-zero value is good. The main reasons for this is to assure that PATH_MAN.COM is present and allow the path element number to be passed to the batch file. 13 RUNNING PATH_MAN PATH_MAN Version 1.1 Shareware message A shareware message may be randomly displayed at the end of PATH_MAN. Pressing any key will exit the program. By registering your use of PATH_MAN, you will be able to use the registration serial number to suppress this shareware message display. Examples For the purpose of these examples, assume that only files PATH_MAN.COM, XYZ.COM and ABC.COM are on PATH directories. Batch file code segment examples - File found - ... PATH_MAN ABC.COM [errorlevel set to 1] IF ERRORLEVEL 1 GOTO RUN ECHO PROGRAM ABC.COM IS MISSING! GOTO EXIT ... :RUN [batch file branches to this point] ... :EXIT File not found - ... PATH_MAN CBA.COM [errorlevel set to 0] IF ERRORLEVEL 1 GOTO RUN [batch file continues here] ECHO PROGRAM CBA.COM IS MISSING! GOTO EXIT ... :EXIT Command line code examples - For - PATH_MAN XYZ.COM? a display of - Found═>[path]\XYZ.COM ERRORLEVEL═>1 For - PATH_MAN XYZ.*? a display of - Found═>[path]\XYZ.COM ERRORLEVEL═>1 For - PATH_MAN XYZ.A*? a display of - Not Found═>XYZ.A* ERRORLEVEL═>0 14 PATH_MAN FILES PATH_MAN is normally distributed as compressed archives consisting of the fol- lowing files (these files are included in the compressed file PVMANvvv, where vvv is the version): Files required for PATH_MAN operation: PATH_MAN.COM . . Executable program Files included to aid in the use of PATH_MAN: PATH_MAN.DOC . . PATH_MAN documentation manual PATH_MAN.ICO . . PATH_MAN Windows icon PATH_MAN.ORD . . Shareware/retail registration order form PATH_MAN.PIF . . PATH_MAN Windows program information file Additional files in the distribution archive: DESC.SDI . . . . BBS program description FILE_ID.DIZ . . . BBS program description README.PM . . . . Text file consisting of program summary, features, and history SYSOP.DOC . . . . SYSOP distribution information VENDOR.DOC . . . Diskette/CD ROM vendor distribution information PATH_MAN.LST . . List of PATH_MAN files in the distribution file The registered version diskette includes these additional files: Installation files: INSTALL.EXE . . . Installation program INSTALL.HLP . . . Installation program help file INSTALLZ.EXE . . Installation unpack program INST_SYS.ZIP . . Installation program files README . . . . . Installation read me file The files that can be generated or used by PATH_MAN consist of: PATH_MAN.REG . . PATH_MAN registration information. 15 PATH_MAN FILES PATH_MAN Version 1.1 16 INDEX Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Computer key conventions . . . . . . . . . . . . . . . . . . . . . . . . . . 1 ERRORLEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 13, 14 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 From a diskette vendor . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Installation on non-path referenced directories . . . . . . . . . . . . . . . 5 Installing the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Major features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Manual format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Operation . . . . . . . . . . . . . . . . . . . . . . . . . 1, 5, 7, 11, 13, 15 Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 13 Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 PATH_MAN files . . . . . . . . . . . . . . . . . . . . . . . . . . 5, 9, 10, 15 Program operation with Microsoft Windows . . . . . . . . . . . . . . . . . . 11 Registered version . . . . . . . . . . . . . . . . . . . . . . . . . . . 5, 15 Running PATH_MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5, 13 Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . ii, 1-3, 5, 14, 15 Shareware distributed documentation manual . . . . . . . . . . . . . . . . . 2 Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Support BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii, 3 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii, 3 ■■■■_MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 17